package com.sz.virtualbank.dao.mapper;

import com.sz.virtualbank.dao.entity.TradeRecord;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * A交易记录Mapper接口
 * 
 * @author Claude
 */
@Mapper
public interface TradeRecordMapper {
    
    /**
     * 插入交易记录
     * 
     * @param tradeRecord 交易记录信息
     * @return 影响行数
     */
    int insert(TradeRecord tradeRecord);
    
    /**
     * 根据ID查询交易记录
     * 
     * @param id 交易记录ID
     * @return 交易记录信息
     */
    TradeRecord selectById(Long id);
    
    /**
     * 根据交易流水号查询交易记录
     * 
     * @param tradeNo 交易流水号
     * @return 交易记录信息
     */
    TradeRecord selectByTradeNo(String tradeNo);
    
    /**
     * 根据用户ID查询交易记录列表
     * 
     * @param userId 用户ID
     * @param offset 偏移量
     * @param limit 查询条数
     * @return 交易记录列表
     */
    List<TradeRecord> selectByUserId(@Param("userId") Long userId, @Param("offset") int offset, @Param("limit") int limit);
    
    /**
     * 根据用户ID和交易类型查询交易记录列表
     * 
     * @param userId 用户ID
     * @param tradeType 交易类型
     * @param offset 偏移量
     * @param limit 查询条数
     * @return 交易记录列表
     */
    List<TradeRecord> selectByUserIdAndType(@Param("userId") Long userId, @Param("tradeType") Integer tradeType, 
                                           @Param("offset") int offset, @Param("limit") int limit);
    
    /**
     * 根据用户ID和日期范围查询交易记录列表
     * 
     * @param userId 用户ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param offset 偏移量
     * @param limit 查询条数
     * @return 交易记录列表
     */
    List<TradeRecord> selectByUserIdAndDateRange(@Param("userId") Long userId, 
                                                @Param("startTime") LocalDateTime startTime, 
                                                @Param("endTime") LocalDateTime endTime,
                                                @Param("offset") int offset, 
                                                @Param("limit") int limit);
    
    /**
     * 更新交易状态
     * 
     * @param id 交易记录ID
     * @param status 交易状态
     * @return 影响行数
     */
    int updateStatusById(@Param("id") Long id, @Param("status") Integer status);
    
    /**
     * 查询交易记录总数
     * 
     * @param userId 用户ID
     * @return 交易记录总数
     */
    int selectCountByUserId(Long userId);
    
    /**
     * 根据用户ID和交易类型查询交易记录总数
     * 
     * @param userId 用户ID
     * @param tradeType 交易类型
     * @return 交易记录总数
     */
    int selectCountByUserIdAndType(@Param("userId") Long userId, @Param("tradeType") Integer tradeType);
    
    /**
     * 根据用户ID和日期范围查询交易记录总数
     * 
     * @param userId 用户ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 交易记录总数
     */
    int selectCountByUserIdAndDateRange(@Param("userId") Long userId, 
                                       @Param("startTime") LocalDateTime startTime, 
                                       @Param("endTime") LocalDateTime endTime);
    
    /**
     * 更新交易记录
     * 
     * @param tradeRecord 交易记录信息
     * @return 影响行数
     */
    int update(TradeRecord tradeRecord);
}
